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of a communication device. The 



A communication system for monitoring and/or controlling communication parameters 
communication system monitors a communication channel that is created when the communication device connects to a network, controls the 
communication device as it operates on the network, and configures the comra unication device. The communication device is commonly a 
modem and is communicatively coupled to the network to carry out ongoing communications between the modem and the network through 
the communication channel. Further, a software module is associated with the modem, and the software module accesses the internal settings 
of the modem via the communication channel (if necessary) and performs operations such as monitoring, controlling, and configuring the 
modem (or other communication device) using the internal settings of the modem. 
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INTERNATIONAL APPT JCATION 
UNDER THE PATENT COOPERATION TREATY 

TITLE: Method and Apparatus for Monitoring, Controlling, and 

Configuring Local Communication Devices 

A portion of the disclosure of the patent document contains material which is subject 
to copyright protection. The copyright owner has no objection to the facsimile reproduction 
by any-one of the patent document or the patent disclosure, as it appears in the publication of 
the International Application, but otherwise reserves all copyright rights whatsoever. 
L Technical Field 

The present invention relates to communication systems and more particularly to a 
computer communication system that, among other things, monitors, controls, and configures 
communication parameters of the computer communication system while one computer system 
communicates with another computer system. 

2. Background Art 

In traditional implementations, control and monitoring of computer communication 
systems primarily concern monitoring and controlling internal parameters of modems and are 
performed through the use of modem control strings such as "AT commands". AT commands 
require a user to switch the modem from data to command mode so that the modem can be 
controlled with AT commands. Thus, AT commands interfere with the typical data flow of the 
modem and the commands do not reflect the true state of the modem in real time. Of note, in 
some traditional hardware modem implementations, limited control and status monitoring 
capabilities are obtained through adding special non-standard hardware interfaces. However, 
these special hardware interfaces are a relatively expensive solution to the problem of real time 
modem monitoring and the usage is limited due to its complexity. 
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If the user chooses not to add the additional network equipment to retrieve the modem 
information, the user is forced to rely on verbal guidance from another person, such as a support 
technician, located at a second modem site. This support technician views the parameters of the 
modem connection from their end of the connection, performs a modem diagnosis based on 
5 available resources, and reports configuration options to the user for manual modem control and 
monitoring. Clearly, this process for modem monitoring and control is unsatisfactory because, 
among other things, the process requires detailed and easily misunderstood verbal instructions 
for modem configuration, the process requires the modem to be switched from data to command 
mode to enter the diagnostic commands for modem configuration, and at least two people are 
10 required to diagnose and configure a single modem. Thus, the monitor and configuration 
process is time consuming and frustrating for those involved. 

Of current interest is a computer communication system that overcomes the 
disadvantages of the related art. Among other advantages and benefits, the computer 
communication system according to the principles of the present invention monitors, controls, 
is and configures communication parameters of the computer communication system while one 
computer system communicates with another computer, system. In one embodiment, the 
computer communication system provides a modem monitor and control system that provides 
modem monitoring and control without requiring user interaction or switching the modem 
between data and command modes. 
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DISCLOSURE OF THE IN VENTION 

Various, aspects of the present invention can be found in a communication system for 
monitoring and controlling communication parameters of a communication device. The 
communication system includes a communication device (often a modem) and a 
communication channel. The communication device, e.g., the modem, has internal settings 
representing communication parameters and is communicatively coupled to the 
communication channel to carry out ongoing communications from the modem through the 
communication channel. The communication system also includes a software module that is 
associated with the modem. The software module accesses the internal settings of the modem 
via the communication channel and performs diagnostics using the internal settings of the 
modem. 

The software module of the communication system also includes a modem interface 
that interacts with the software module and assists the software module in performing 
diagnostics using the internal parameters of the modem. The software module accesses the 
communication channel transparently to the ongoing communications from the modem when 
the software module performs the diagnostics using the internal parameters of the modem. 
The software module may also access the communication channel without detrimentally 
affecting the ongoing communications across the communication channel. The software 
module may also perform diagnostics using the internal parameters of the modem via the 
same communication channel that is used to carry out ongoing communications to and from 
the modem. 

In other embodiments, the diagnostics performed by the software module of the 
communication system comprises monitoring a data stream in the communication channel. 
The diagnostics performed by the software module may comprise configuring the internal 
settings of the modem based on information obtained regarding a data stream to and from the 
modem. The diagnostics may also comprise controlling the internal settings of the modem 
according to information obtained regarding a data stream to and from the modem. The 
communication system may also include a user interactive interface in the software module 
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for diagnostics and a plurality of software modules associated, respectively, with each of a 
plurality of modems. 

The modem of the communication system is frequently communicatively coupled to 
the communication channel and thus to a network. The network is selected from the group 
consisting of at least a local area network, a wide area network, and a global area network. 

Various other aspects of the present invention can be found in a communication 
system comprising a first communication device having internal parameters, a second 
communication device having internal parameters and being communicatively coupled to the 
first communication device, a communications link that passes a data stream between the first 
communication device and the second communication device, and a module associated with 
the communications link that adjusts the internal parameters of the first communication 
device based on characteristics of the internal parameters of the first communication device, 
the second communication device, or both. 

The module of the communication system may also include a communication 
interface that interacts with the communications link such that the module operates 
transparently to the data stream of the communications link. Further, the first communication 
device may comprise a local communication device and the second communication device 
comprises a remote communication device. The first communication device and the second 
communication device, respectively, often comprise a first modem and a second modem. 
The communications link often operates on a network being selected from the group 
consisting of a local area network, a wide area network, and a global area network. In many 
embodiments, the communication system comprises a computer communication system and 
the module adjusts the internal parameters of the first communication device based on 
characteristics of the internal parameters of the first communication device, the second 
communication device, or both. 

Still further aspects of the present invention are found in a method for adjusting 
parameters of a communication system. The method comprises establishing a 
communications link between a first communication device and a second communication 
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device, each communication device having internal parameters influencing communication 
protocols on the communications link; obtaining a software module for interacting with the 
communications link; retrieving, with the software module, characteristics of the first 
communication device based on the internal parameters of the first communication device, 
the second communication device, or both; and adjusting the internal parameters according to 
the retrieved characteristics to optimize communication between the first and the second 
communication devices on the communications link. 

Adjusting the internal parameters may include adjusting the internal parameters of the 
first communication device, and, in addition, adjusting the internal parameters may include 
monitoring or controlling the internal parameters of the first communication device. Further, 
retrieving characteristics of the first communication device may comprise retrieving the 
characteristics transparently to the data passing, through the communications link and/or 
retrieving the characteristics such that the data passing through the communications link is 
not detrimentally affected. 

In other aspects of the present invention, the communication system monitors a 
communication channel that is created between a first modem and a second modem and 
controls the first modem by adjusting internal settings of the first modem that represent 
communication parameters. The second modem is communicatively coupled to the first 
modem to carry out ongoing communications between the first modem and the second 
modem through the communication channel. Further, a software module is associated with 
the first modem, and the software module accesses the internal settings of the first modem, 
via the communication channel or otherwise, and performs diagnostics using the internal 
settings of the first modem. Of course, the software module could access the internal settings 
of the first modem directly to perform diagnostics using the internal settings of the first 
modem. 

The software module of the communication system typically includes a modem 
interface that interacts with the software module and assists the software module in 
performing diagnostics using the internal parameters of the first modem. Also, whether 
monitoring or controlling the first modem, the software module accesses the communication 
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channel transparently to the ongoing communications between the first modem and the 
second modem when the software module performs the diagnostics. Further, the software 
module accesses the communication channel without detrimentally affecting the ongoing 
communications between the first modem and the second modem. 

In another embodiment, the software module configures the first modem using the 
internal parameters of the first modem. 

The diagnostics performed by the software module of the communication system 
include monitoring a data stream in the communication channel in view of the internal 
settings of the first modem. Further, the diagnostics performed by the software module 
10 comprise configuring the internal settings of the first modem based on information obtained 
regarding the data stream between the first modem and the second modem. In addition, the 
diagnostics performed by using the software module comprise controlling the internal settings 
of the first modem according to information obtained regarding the data stream between the 
first modem and the second modem. 
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It should be noted that the software module may include either a user interactive 
interface for diagnostics, or an automatic interface for diagnostics that requires no further user 
interaction. Further, the communication system may include a plurality of software modules 
being associated, respectively, with each of a plurality of modems. Regardless of the number 
of modems in the communication system, the modems are communicatively coupled via a 
network. The network is typically selected from the group consisting of a local area network, 
a wide area network, and a global area network, however, the network may include any 
combination of a local, wide, or global area network. In other words, the network could 
operate according to almost any existing network protocol, e.g., a peer-to-peer network, a 

transmission control protocol/Internet protocol network (TCP/IP), etc. 

■> 

In another embodiment, the present invention can be described as a communication 
system comprising a first communication device having internal parameters; a second 
communication device having internal parameters and being communicatively coupled to the 
first communication device; a communications link that passes a data stream between the first 
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communication device and the second communication device; and a module associated with 
the communications link that adjusts the internal parameters of the first communication 1 
device based on characteristics of the internal parameters of the first communication device. 

In this embodiment, the module may include a communication interface that interacts 
with the communications link such that the module operates transparently to the data stream 
of the communications link. Further, th<? first communication device may be a local 
communication device and the second communication device may be a remote 
communication device. In addition, similar to the first embodiment, the communications link 
operates on a network such as a local area network, a wide area network, or a global area 
network or a combination thereof. In many embodiments, the communication system is 
designed for modems operating in a computer communication system. Thus, to assist in 
understanding the principles according to the present invention, the exemplary embodiments 
are generally described using computer systems communicating with modems. 

TtRTFF DESCRIPTION O F DRAWINGS 

A better understanding of the present invention can be obtained when the following 
detailed description of the preferred embodiment is considered in conjunction with the 
following drawings, in which: 

Figure 1 is a block diagram of an exemplary computer communication system 
according to the principles of the present invention wherein the system is associated with an 
application for providing a computer system access to a communication channel via a 
modem. 

Figure 2 is a block diagram of an exemplary modem monitor/control interface of the 
computer communication system of Figure 1. 

Figure 3 is a block diagram illustrating an exemplary modem for operation with the 
computer communication system of Figure 1. 
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Figure 4 is a block diagram of an exemplary computer communication system for 
monitoring and controlling both a local modem and a remote modem over a telephone line. 

Figure 5 is a block diagram of exemplary computer communication systems operating 
modem monitor/control applications, respectively, on both a client modem and a server 
modem in a peer-to-peer network. 

Figure 6 is a block diagram of exemplary computer communication systems operating 
modem monitor/control applications, respectively, on both a local computer system and a 
remote computer system, the systems communicating across the Internet. 

Figure 7 is a block diagram of an exemplary computer communication system 
operating according to simple network management protocol (SNMP) parameters such that a 
management application provides for trouble shooting of a local modem from remote 
locations. 
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MOTIFS FOR CARRYING OUT THK INVENTION 

Figure 1 is a block diagram of an exemplary computer communication system 100 
that operates according to the principles of the present invention. For ease of understanding, 
the system 100 is associated with a computer software application 102 for providing a 
computer system 104 access to a communication channel 106 via a communication device 
such as a modern 108. The computer software application 102 is commonly a typical 
computer telecommunications application such as a "web browser", viz., Netscape™, Internet 
Explorer™, etc., or a modem utility, viz., Procomm™, etc. In short, the computer software 
application 102 utilizes the modem 108 capabilities to communicate with other modems 
through the communication channel 106. While the computer software application 102 uses 
the modem 108 to communicate with other modems, the computer communication system 
100 examines the modem parameters of the modem 108 to determine if the modem 
configuration needs to be modified to attain optimal performance through the communication 
channel 106. As stated, the computer communication system .100 is an exemplary 
embodiment that is used to facilitate understanding oQhej)rinci>les according to the present 
invention. It should be understood that the present invention applies equally well to 
communication systems that operate with communication devices other than modems. 
However, for ease of understanding, the present invention will be described relative to 
computer communication systems using modems as the communication devices. 

The computer communication system 100 includes a modem monitor/control 
application 110 that performs diagnostics on the modem 108 through a modem 
monitor/control interface 112 (the modem monitor/control application 110 and the modem 
monitor/control interface 112 sometimes collectively referred to herein as a "software 
module"). Thus, diagnostics can be performed on the "local" modem 108. Advantageously, 
some of the diagnostics can also occur transparently to ongoing communications in the 
communication channel 106. Thus, the modem communication connection, a.k.a., the "data 
stream", of the modem 108 can pass through the communication channel 106 without being 
detrimentally affected during diagnostics. Further, the diagnostics can be performed via user 
interaction through the modem monitor/control application 110 or, alternatively, certain 
diagnostics can be automated and performed independently of user interaction through the 
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application 110. As stated, if changes in the modem parameters are required to obtain 
optimal performance in the modem 108, some of the changes can be made without 
interruption in the data stream. Of course, the modem 108 could be a software modem or a 
hardware modem or any combination thereof, a pure software modem being defined as a 
modem implemented entirely in software and relying on a computer's processor to modulate 
and demodulate signals. Of note, although graphical line 114 represents direct coupling of 
the modem monitor/control interface 112 with the modem 108, the modem monitor/control 
interface 112 could instead be directly coupled to an operating system communication driver 
1 16 as represented by dashed line 118. Further, the term "diagnostics", as used herein, refers 
at least to monitoring, controlling, or configuring a modem. 

Figure 2 is a block diagram of the exemplary modem monitor/control interface 1 12 of 
the computer communication system 100. The modem monitor/control interface 112 
includes a modem monitor/control application programming interface (API) 200, a modem 
monitor/control data link library (DLL) 202 that operates similarly to standard DLL software 
components, and a modem monitor/control driver 204 that operates similarly to standard 
software drivers. The API 200 provides code for monitoring and controlling a software 
modem while the modem is running or passing a data stream (see Appendixes A, B, and C). 
API 200 provides an easy method to write applications that provide various diagnostics that 
monitor parameters that change in real time (such as MSE, baud rate, echo canceller 
coefficiencies, etc.) as well as enabling the writing of applications that allow internal 
parameters to be controlled while a telephony session is in progress. The API 200 can also 
provide easy means for field support by looking at various parameters and causing the 
modem to dump data into a file to be investigated later. Further, trouble shooting can be 
performed by changing various parameters while a data stream is running through the 
modem. Of note, in a preferred embodiment, the API 200 operates asynchronously and in 
parallel with the ordinary modem operation and does not interfere with the data stream. 
Thus, API 200 provides a true view of the modem parameters and does not slow the data 
transfer process. 
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Appendixes A, B, and C include exemplary embodiments of code portions of the API 
200 and include three functions that could be considered the backbone of the API 200. First,' 
the ModemConfigure function configures parameters within the modem and should be called 
only before the modem is activated. Second, the ModemControl function changes parameters 
within the modem to control the modem's operation and can be called during modem 
operation. Finally, the ModemMonitor function returns the current value of a parameter or 
set of parameters within the modem and can also be called during modem operation. The 
first parameter of the above functions is a code indicating which parameter (or parameter set) 
to monitor or change. The codes can be easily extended from time to time to provide 
additional visibility and control options for the modem. The same interfaces apply for 
additional parts of the modem such as speakerphone, tone detection/generation, etc. Thus, 
the computer communication system 100 is extendable and easy to use and can be used to 
monitor and control a modem without interfering with the ordinary operation of the modem. 
Further, the computer communication system 100 provides an easy method to develop 
applications for modem diagnostics and trouble shooting. 

Figure 3 is a block diagram illustrating the exemplary modem 108 for operation with 
the computer communication system 100 that is associated with a computer system 104 for 
accessing a network. The exemplary modem 108 includes a port driver 300, a controller 302, 
a data pump abstraction layer (DPAL) 304, an advanced modem operation scheduler (AMOS) 
306, a sample buffer management module 308, a hardware interface 310, and signal 
processing tasks 312. Of course, the exemplary modem 108 could be realized in various 
manners depending on the number of components implemented in software. The components 
most suited for either a software or a hardware implementation are the controller 302, the 
DPAL 304, the AMOS 306, the sample buffer management module 308, and the signal 
processing tasks 312. Thus, although it is contemplated to implement other components in 
either hardware or software, the stated components are most commonly implemented in either 
hardware or software. Advantageously, implementation of the signal processing tasks 312 in 
software provides modularity and updating of individual tasks without affecting other 
components of the modem 108. In addition, implementing multiple individual signal 
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processing tasks 312 allows for more efficient usage of memory in the computer system 104 
operating with the modem 108 according to the present invention. 

Figure 4 is a block diagram of an exemplary computer communication system 400 for 
monitoring and controlling, in a computer system 401, a local modem 402 as it communicates 
with a remote modem 404 of another computer system 405 over a telephone line 406. 
Similar to the computer communication system 100, the computer communication system 
400 includes a modem monitor/control application 408 and a modem monitor/control 
interface 410. The local modem 402 is monitored/controlled just as the modem 108 is 
monitored and controlled. In addition, the remote modem 404 can be monitored by the 
computer communication system 400 by using some of the bandwidth of the telephone line 
406. Of course, if the communication devices were not modems and they communicated 
across something other than a telephone line, similar usage of the bandwidth on the line 
would enable functionality of the communication system 400. 

A data stream is created on the telephone line 406 between the local modem 402 and 
the remote modem 404, the data stream representing a modem connection. The telephone 
line 406 is used to transfer modem diagnostics and/or control information to/from the remote 
modem 404 by either "stealing" some of the data bits or using an alternative channel 
whenever applicable (e.g., V.34 control channel). The extraction of the diagnostic 
information can be performed in one of at least two manners. 

1. A specific application can be run on the remote side that extracts modem 
parameters from the data stream and then sends them via the modem to the local 
side. The specific application can also receive control commands from the local 
modem and apply the commands to the remote modem. 

2. The remote modem itself multiplexes the diagnostic information in the data stream 
(or the control channel) and monitors control commands without any interference 
from outside. The multiplexing/demultiplexing can be performed on any of the 
following two levels: by a data pump, or by an active data protocol (V.42, V.17). 
This second implementation for extracting diagnostic information from the data 
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stream is particularly suitable for software modem implementations where the 
modem can be easily modified for that kind of data manipulation and a wide' 
variety of modem parameters can be extracted (e.g., see ModemMonCtrl API of 
the Appendixes). 

In this manner, modem parameters from the remote modem 404 can be monitored and 
the remote modem 404 can be controlled witl} new parameters being set in the remote modem 
404 from the computer communication system 400. Of course, the data stream between the 
local modem 402 and the remote modem 404 is ongoing and, potentially, the data stream 
passes without interruption from the computer communication system 400 regardless of 
whether the modems are software, hardware, or combination software/hardware modems. 



Figure 5 is a block diagram of exemplary computer communication systems operating 
modem monitor/control applications, respectively, on both a client modem 500 in a local 
computer system 501 and a server modem 502 in a remote computer system 503. The local 
and remote computer systems 501, 503 communicate across a peer-to-peer network 504. A 
client computer communication system 506 communicates with the client modem 500 while 
telecommunication software or application 508 having an operating system communication 
driver 510 uses the client modem 500 to maintain a modem connection across the peer-to- 
peer network 504. Similar to the computer communication systems 100 and 400, the client 
computer communication system 506 operates in a manner to monitor/control the client 
modem 500 and/or the server modem 502. The difference in this embodiment pertains to the 
computer communication systems including both the client computer communication system 
506 and a server computer communication system 512. This arrangement is provided to 
ensure accurate monitoring and/or controlling of both server and client modems. In addition,- 
this embodiment demonstrates the flexibility of the system according to the present invention 
2 5 and expands the control options of the software. 

Figure 6 is a block diagram of exemplary computer communication systems operating 
modem monitor/control applications, respectively, on both a local computer system 600 
having a local modem 601 and a remote computer system 602. The local and remote 
computer systems 600, 602 communicate across a network 604. This embodiment illustrates 
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a structure similar to Figure 5 except that, rather than peer-to-peer network 504, the local and 
remote computer systems 600, 602 communicate across the network 604, the network 604 
often being the Internet. Of course, the same advantages and benefits previously described in 
relation to modem monitoring, controlling, and configuring (a.k.a., diagnostics) are realized 
when the modem 601 operates so as to access the Internet through an Internet service 
providers (ISP). Of course, if a communication device other than modem 601 is used to 
implement communication across the network 604, monitoring/controlling/configuring can be 
performed in a similar manner as described herein. 

Figure 7 is a block diagram of an exemplary computer communication system 
operating according to simple network management protocol (SNMP) parameters such that 
computer systems 700 can perform remote trouble shooting of a modem 702 in another 
computer system 704 by viewing a modem web page 706. This exemplary embodiment 
demonstrates how a single manager or system administrator, SNMP server 708, monitors and 
controls numerous client modems across a network 710. The network 710 is commonly a 
network such as the Internet. In this embodiment, SNMP, a common network management 
protocol, serves as the underlying communication protocol for the computer systems 700, 
704. Thus, a single manager, SNMP server 708, can monitor and control modems such as the 
modem 702. Of course, other network management protocols could be used to implement the 
principles according to the present invention and the description of SNMP operating over the 
network 710 should not be construed to limit the appended claims. 

The above-listed sections and included information are not exhaustive and are only 
exemplary for certain computer/modem/network systems. The particular sections and 
included information in a particular embodiment may depend upon the particular 
implementation and the included devices and resources. Although a system and method 
according to the present invention has been described in connection with the preferred 
embodiments, it is not intended to be limited to the specific form set forth herein, but, on the 
contrary, it is intended to cover such alternatives, modifications, and equivalents as can be 
reasonably included within the spirit and scope of the invention as defined by the appended 
claims. 
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Appendix A 



#ifndef _MODEP4_CTRL_H_ 
#define _MODEM_CTRL_H_ 

#include <Windows.h> // To provide types definition, can be replaced by 
any alternative type defining file 
#include "ModemCodes .h" 

i 

#ifdef cplusplus 

extern "C" { 
tfendif 

VOID WINAPI ModemGetLastError ( PCHAR pBuf , PWORD nBuf ) ; 

/* 

The GetModemCodesVersion function returns the version of the control codes 
header file. : 

It should be used to verify cohernece between the modem control API user 

and provider. 

*/ 

DWORD WINAPI ModemGetCodesVersionO ; 



/* 

The ModemOpen function returns a handle that can be used to access 
a data-pump object. 

Parameters : 

dwDpIdCode - Specifies the type identification code of the data pump. 

This value identifies the specific data pump to be monitored or 
controled . 

The data pump type identification codes are defined by the type 
RK_DP_IDS 

(file "ModemCodes .h") . 

Return Values : 

If the specified data pump type exists and the function succeeds, 

the return value is an open handle to the specified modem. 

If the function fails, the return value is INVALID_HANDLE_VALUE . 

*/ 

HANDLE WINAPI ModemOpen { 
DWORD dwDpIdCode 

) ; 



/* 

The ModemClose function closes an open object handle. 
Parameters : 

hModem - Identifies an open object handle to one of the following objects 
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CModem 
Return Values : 

If the function succeeds, the return value is TRUE. 
If the function fails, the return value is FALSE. 

*/ 

BOOL WINAPI ModemClose ( 

HANDLE hModem // handle to object to close 

) ; 

/* 

The functions: ModemConf igure , ModemControl , ModemMonitor 
send a control code to a specified CModem object, 

causing the corresponding device to perform the specified operation. 
ModemConf igure has to be called BEFORE the specified modem has been 
activated. 

ModemControl and ModemMonitor may be called DURING modem operation. 
Parameters : 

hModem - Handle to the CModem instance that is to perform the operation. 

Call the CreateModem function to obtain a CModem handle. 
dwConf igCode/dwControlCode/dwMonitorCode - Specify the control code for the 
operation . 

This value identifies the specific configuration to be 

performed by 

ModemConf igure/ModemControl /ModemMonitor respectively. 

The control codes are defined by types 
RK_CFG_CODES / RK_CTL_CODES / RK_MON_CODES 

(file "ModemCodes.h") . 
plnBuffer - Pointer to a buffer that contains the data required to perform 
the operation. 

This parameter can be NULL if the dwConfigCode parameter 
specifies an operation 

that does not require input data. 
nlnBufferSize - Specifies the size, in bytes, of the buffer pointed to by 
plnBuffer. 

pOutBuffer - Pointer to a buffer that receives the operation's output data. 

This parameter can be NULL if the dwConfigCode parameter 
specifies an operation 

that does not produce output data. 
nOutBuf ferSize - Specifies the size, in bytes, of the buffer pointed to by 
pOutBuffer. 

pBytesReturned - Pointer to a variable that receives the size, in bytes, 
of the data stored into the buffer pointed to by pOutBuffer. 

Return Values : 

If the function succeeds, the return value is TRUE. 

If the function fails or the specified operation is not supported 

for the specified object, the return value is FALSE. 

*/ 

BOOL WINAPI ModemConf igure ( 
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HANDLE hModem , 
interest 



10 



DWORD 
PVOID 
DWORD 
PVOID 
DWORD 
PDWORD 
count 
) ; 



dwConf igCode , 
plnBuf f er , 
nlnBuf f erSize, 
pOutBuf f er , 
nOutBuf f erSize , 
pBytesReturned 



// handle to CModem instance of 

// control code of operation to perform 
// pointer to buffer to supply input data 
// size of input buffer 

// pointer to buffer to receive output data 
// size of output buffer 

// pointer to variable to receive output byte 
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20 



BOOL WINAPI ModemControl ( 
hModem, 

dwControlCode , 
plnBuffer, 
nlnBuf f erSize , 
pOutBuf f er, 
nOutBuff erSize , 
pBytesReturned 



HANDLE 
interest 
DWORD 
PVOID 
DWORD 
PVOID 
DWORD 
PDWORD 
count 
1 ) ; 



// handle to CModem instance of 

// control code of operation to perform 
// pointer to buffer to supply input data 
// size of input buffer 

// pointer to buffer to receive output data 
// size of output buffer 

// pointer to variable to receive output byte 



BOOL WINAPI ModemMonitor ( 



25 



30 



HANDLE 

interest 

DWORD * 

PVOID 
DWORD 
PVOID 
DWORD 
PDWORD 

count 
) ; 



hModem, 

dwMonitorCode , 
plnBuf f er , 
nlnBuf f erSize , 
pOutBuf f er , 
nOutBuff erSize , 
pBytesReturned 



// handle to CModem instance of 

// control code of operation to perform 
// pointer to buffer to supply input data 
// size of input buffer 

// pointer to buffer to receive output data 
// size of output buffer 

// pointer to variable to receive output byte 



35 



40 



#ifdef cplusplus 

} 

#endif 

#endif / /_MODEM_CTRL_H_ 
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Appendix B 



#ifndef 
#def ine 



_MODEM_CODES_H_ 
MODEM CODES H 



10 



15 



20 



25 



30 



35 



tfd'efine MODEM_CODES_VERSION 



// rate 
#def ine 
#def ine 
#def ine 
#def ine 
#def ine 
#def ine 
#def ine 
#def ine 
#def ine 
#def ine 
#def ine 
#def ine 
#def ine 
#def ine 
#def ine 
#define 
#def ine 
#def ine 
#def ine 
#def ine 
#def ine 
#def ine 
#def ine 
#def ine 
#def ine 
#def ine 
#def ine 
#def ine 
#def ine 
#def ine 
#def ine 



masks returned by RKMON_SUPPORTED_B ITERATE 



RK_RATE_MAS K_ 


75 


0x00000001 


RK_RATE_MASK_ 


300 


0x00000002 


RK_RATE_MASK_ 


600 


0x00000004 


RK_RATE_MAS K_ 


12 00 


0x00000008 


RK_RATE_MASK_ 


2400 


0x00000010 


RK_RATE_MASK_ 


4800 


0x00000020 


RK_RATE__MASK_ 


7200 


0x00000040 


RK_RATE_MAS K_ 


9600 


0x00000080 


RK_RATE_MASK_ 


12000 


0x00000100 


RK_RATE_MAS K_ 


14400 


0x00000200 


RK_RATE_MAS K_ 


16800 


0x00000400 


RK_RATE_MASK_ 


19200 


0x00000800 


RK_RATE_MASK_ 


21600 


0x00001000 


RK_RATE_MASK_ 


24000 


0x00002000 


RK_RATE_MAS K_ 


26400 


0x00004000 


RK_RATE_MASK_ 


_28800 


0x00008000 


RK_RATE_MASK 


_31200 


0x00010000 


RK_RATE_MASK 


~33600 


0x00020000 


RK_RATE_MASK 


~32000 


0x00040000 


RK__RATE_MAS K 


"34000 


0x00080000 


RK_RATE_MAS K 


_36000 


0x00100000 


RK_RATE_MASK 


_38000 


0x00200000 


: RK RATE MASK 


40000 


0x00400000 



RK_RATE_MAS K_4 2 0 0 0 
RK_RATE_MAS K__4 4 00 0 
RK_RATE_MASK_4 60 00 
RK_RATE_MASK_4 8 00 0 
RK_RATE_MAS K_5 0 0 0 0 
RK_RATE_MAS K_5 2 0 0 0 
RK_RATE_MAS K_5 4 000 
RK RATE MASK 56000 



0x00800000 
0x01000000 
0x02000000 
0x04000000 
0x08000000 
0x10000000 
0x20000000 
0x40000000 



40 // DataPump type codes 
typedef enum { 

RKID_V32BIS = 0, 

RKID_V34, 

RKID_V22BIS, 
45 RKID_V23, 

RKID V21, 



50 



RKID_V17, 
RKID_V29, 
RKID_V27, 

RKID V8, 
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RKID_TONE_DET, 
RKID_TONE_GEN , 
RKID_DTMiF_DET , 
5 RKID_DTMF — GEN , 

RKID_CR_TONE_DET , 
RKID_CR_TONE_GEN , 

RKID_RKS AMPLE, 
1 0 RKID_ANS_DET , 

RKID_ANS_GEN, 
RKID_WINAC, 
RKID_ROKV42, 

15 RKID_K5 6 FLEX , 

RKID_BELL103, 
RKID_BELL2 1 2 A , 
RKID_SPKP , 
RKID_VOICE, 

20 

RKID_V90, 

RKID_AMOS , 

25 RKID_LAST, 
} RK_DP_IDS; 



// Offset definitions: 

30 #define COMMON__RK_CODES 0 

#define RKSAMPLEJRK_CODES 2 000 

#define WINAC_RK_CODES 3 000 

tfdefine V42_RK_CODES 4 000 

35 

#define AUTOMODE_RK_CODES 6000 

#define V8_RK_C0DES 7000 

#define V21_RK_CODES 10000 

40 #define V22_RK_CODES 11000 

#def ine FSK_RK_CODES 12000 

#define FAX_RK_CODES 14000 

4 5 #define V32_RK_CODES 16000 

#define V34_RK_CODES 18000 

#define V90JRK_CODES 2 0 000 

50 

#define SPKP_RK_CODES 2 5000 

#define VOICE_RK_CODES 26000 

55 #define AMOS_RK__CODES 2 7 000 

19 



// V8, V8BIS 

// V22, Bell-212A 

// V23, Bell-103 

// V27, V27BIS, V2 7TER, V29, V17 

// V32, V32BIS 

// K56FLEX , V90 
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10 



15 



20 



// Modem Config Codes 

(In) Parameter (Out) 

typedef enum 

{ 

// ********* common Constants ********** 

// Select Symbol Rate (no impact if Autorate is enabled) 
RKCFGJTX_SYMBOL_RATE = COMMON__RK_CODES , // 
Symbol Rate None 

RKCFG_RX_SYMBOL_RATE , / / 

- Symbol Rate None 

// Force Bit Rate 

RKCFG_BIT_RATE_RX_MAX , / / 

- Bit Rate None 

RKCFG_BIT_RATE_TX_MAX , / / 

- Bit Rate None 

RKCFG_BIT_RATE_RX_MIN, // 

- Bit Rate None 

RKCFG_J3IT_RATE_TX__MIN, // 

- Bit Rate None 



Parameter 



INT - 



INT 

INT 
INT 
INT 
INT 



25 



30 



// Select connection type ( Half or Full Duplex ) . 
R KC FG__CONNE CT I ON_TYPE , / / 

(FDplex=0 , HDplex=l) None 



DWORD 



// Tx Transmittion Power: {Minimum, Maximum, Default, Offset} 
// (values in dBm, offset in dB) . Offset is for compensation on 
hardware gain. 

RKCFG_TX_S IGNAL_POWER , ' / / 

char [4] None 



35 



40 



45 



50 



// Enable/Disable Rate Renegotiation 

RKCFG_RENEG_ENABLE , 

BOOL - Yes /No None 

// Enable/Disable Retrain 

RKCFG_RETRAIN_ENABLE , 

BOOL - Yes /No None 

// Enable/Disable Rx Freeze 

RKCFG_RX_FREEZE_ENABLE , 

BOOL - Yes/No None 

// Enable/Disable Echo Canceller Freeze 

RKCFG_EC_FREEZE_ENABLE , 

BOOL - Yes/No None 

RKCFG_RECORD_SESSION, 

BOOL - Yes /No None 

RKCFG_SESS ION_NAME , 

char * name None 

RKCFG_NO_CARRIER__T IMEOUT , 
DWORD - in seconds None 



// 

// 
// 
// 

// 



// 



// 
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RKCFG_START_AT_DATA , 
BOOL - Yes /No 



None 



RKCFG_REyiOTE_IS_ROCKWELL , 
5 BOOL - Yes /No None 

RKCFG_MODEM_SETTlNGS , 
// ********* win AC Constants ************* 

10 RKCFG_EC_MODE = WINAC_RK_CODES , 

DWORD ( ERRO*R — CONTRO L_MODE ) 

RKCFG_CMPRS_MODE , 

DWORD (COMPRESSION_MODE) 

RKCFG_ACTIVE_MODULATION , 
15 DWORD (RK_DP_IDS) 

// ********* Auto-Mode Constants ********** 

// Enable/Disable Automode 
20 RKCFG_AUTOMODEJENABLE =AUTOMODE_RK_CODES , / / 

Yes /No None 

// Transmit Timeout for detection for V32 
RKCFG JTRANSMITJTIMEOUT , 
25 DWORD ms None 



// 
// 



// 
// 
// 



// 



BOOL - 



30 



35 



40 



45 



50 
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// 
// 



// 
// 



// ********* V8 Constants ********** 

RKCFG_V8JSUPP0RT_CI = V8_RK_CODES , 
Yes /No None 

RKCFG_V8_CI_CALLING_FUNCTION_SEQUENCE , 
None 

RKCFG_V8_CI_ON_CADENCE , 
DWORD ms cadence None 
RKCFG_V8_CI_OFF_CADENCE , 
DWORD ms cadence None 
RKCFG_V8_AS_CI_DET , 
BOOL None 
********* V21 Constants ********** 

RKCFG_V2 1RX_HIGH_CHANNEL = . V2 l_RK_CODES , / / 
Yes /No None 

RKCFG_V2 1 TX_H I GH_CHANNEL , 
BOOL - Yes/No None 

RKCFG_V2 1 _D AT A_M0DE , 
BOOL None 

// ********* V22 Constants (V22, Bell-212A) ********** 



// 
// 



RKCFG_V22_TO_BELL_212A = V22_RK_C0DES , 
Yes/No None 

21 



// 



// 



BOOL 



BYTE 



BOOL 



BOOL 
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// ********* psK Modulations Constants (V23, Bell-103) ********** 



10 



15 



20 



25 



30 
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RKCFG_FSK_BACK_CHANNEL = FSK_RK_CODES , 
Yes /No None 

RKCFG_FSK_V2 3__CHANNEL , 

BOOL - Yes /No None 

RKCFG_FSK_BELL1 0 3_CHANNEL , 
BOOL - Yes /No None 



// 



BOOL 



// 
// 



RKCFG_FSK_FOR_CID , * 
BOOL - Yes /No None 
// ********* Fax Constants (V27, V29 # V17) ********** 

// Define Retrain between Pages as Short or Long 



RKCFG_LONG_RETRAIN 
( TRUE = Long ) None 

// ********* v32 Constants 



FAX RK CODES, 



********** 



RKCFG_V32BIS_TO_V3 2 = V32_RK_CODES , 

Yes /No None 

RKCFG_V3 2_TRELLIS_SUPPORT , 

BOOL - Yes /No None 

// ********* V34 Constants ********** 

// Select Carrier Frequency 
RKCFG_RX__CARRIER_FREQ = V3 4_RK_CODES , 
V3 4 _c a r r i e r_t None 

// Enable/Disable Transmit Power Drop 
RKCFG_TX_POWER_DROP_ENABLE , 
BOOL - Yes /No None 
// Select Transmit Power Level 
RKCFG_TX_POWER_DROP , 
- Level None 

// Select Requested Power Drop 
RKC FG_REQUE S TED_POWER_DRO P , 
DWORD None 

// Enable/Disable Precoding 
RKCFG_PRECODING_ENABLE , 
BOOL - Yes /No None 
// Set Precoding Coefficients 
RKCFG_PRECODING_COEFFS , 
Array of coeffs None 

// Transmitter Preemphasis Filter 
RKCFG_TX_PREEMPHASIS_FILTER , 
Filter Index None 

// Requested Preemphasis Filter 



// 



// 



// 



// 



// 



// 
// 
// 

// 
// 



// 



BOOL 



BOOL 



INT 



SHORT [6] - 



INT 
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RKCFG_REQUESTED_PREEMPHASIS_FILTER, 
Filter Index None 



// 



// Enable/Disable Constellation Expansion 

RKCFG_CONSTELATION_EXPAND_ENABLE , / / 

Yes /No None 

// Enable/Disable Warping 

RKCFG_WARP__ENABLE , 

BOOL - Yes /No None 
// ********* V90 Constants (K56FLEX, V90) ********** 



INT 



BOOL 



// 



// set the encoding law for flex 1 indicates A-law coding, 0 indicates 

u- law 

RKCFG_ENCODING_LAW = V90_RK_CODES , // BOOL 

(TRUE=A Law) . None 



// * 



* * * * * 



*** speakerPhone Constants ********** 



// Hardware Delay 

RKCFG_EC_DELAY = SPKP_RK_CODES , 

Samples} None 

// cross -Correlator Length 
RKC FG_CC_LENGTH , 
- No of Taps None 

RKCFG_DMP_MASK , 

RKC FG_ I N I T I AL_FULL_DUPLEX_MEASURE , 

} RK_CFG_CODES ; 

// Modem Control Codes 
typedef enutn 

{ 

35 // ********* common Constants ********** 



// Initiate Retrain 

RKCTL_RETRAIN = COMMON_RK_CODES , 

None 

// Initiate Rate Renegotiation 
RKCTL_RENEG , 

INT - Bit Rate None 
// Terminate Connection Gracefully 
RKCTL_CLEARDOWN , 
None 



None 



// Squelch Tx Signal 

RKCTL_TX_S QUELCH , 

None None 

// Use the SendCommand 
RKCTL_SEND_COMMAND , 
{DWORD [2]- Command, Param} None 

// WinAC constants 



//{SPKP_MODULE # INT - No of 
// INT 



// 



None 



// 



// 



// 
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RKCTL_MODEM_SLEEP = WINAC_RK_CODES , 
None 



// 



DWORD 
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// ********* pax Constants (V27, V29, V17) ********** 

// Define Retrain between Pages as Short or Long 
RKCTL_LONG_RE TRAIN = FAX_RK_CODES , // 
( TRUE = Long) None 

// ********* V34 Constants ********** 

// Must be sent before RKMON_DATA_RES_ECHO_GET 
RKCTL_DATA_RES_ECHO_REQUEST=V34_RK_CODES , // 
None 



BOOL 



None 



// ********* speakerPhone Constants 



********** 



// 



// Speakerphone Mode (FD, HD, HS) 
RKCTL_SPKP_MODE = SPKP_RK_CODES , 

None 
// Output Mute 
RKCTL_IO_MUTE , 

{SPKP_PROBE,BOOL - Yes/No} None 

// Echo Cancellers 

RKCTL_F I LTER_LENGTH , 
of Taps} None 

RKCTL_EC_OPERATE , 
Yes /No} None 

RKCTL_ADAPT_ENABLED , 
Yes/No} None 

// AGC and Sw-Loss 

RKCTL_AMP — ENABLED , 

{SPKP_MODULE,BOOL - Yes /No} None 

// Gains 

RKCTL_GAIN , // {SPKP_MODULE* , INT* / FLOAT 

Gain , GAIN_FORMAT* } None 

RKCTL_INIT_GAIN, 
RKCTL_MAX_GAIN , 
RKCTL_FULL_DUPLEX_MEASURE , 

RKCTL_NOISE_INSERTION_LENGTH , 
RKCTL_NOISE_INSERTION_ENABLE , 

RKCTL_FADE_IN_LENGTH , 
RKCTL_FADE_IN_ENABLE , 

RKCTL_UPSTEP, 

RKCTL__M IN_L INE_OUT_POWER , 

RKCTL_LINE_OUT_S ILENCE_GAIN_REDUCTION , 

// ********* AMOS Constants ********** 

RKCTLjcREATE_DATAPUMP = AMOS_RK_CODES , 

24 



SPKPMode 



// 

// . { SPKP_MODULE , INT - No 
// (SPKP_MODULE,BOOL - 

// {SPKP_MODULE,BOOL - 

// 
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RKCTL_DESTROY_DATAPUMP , 
} RK_CTL_CODES ; 

t 

// Modem Monitor Codes 
typedef enum 

{ 

II ********* common Constants ********** 

RKMON_TX_SAMPLE_RATE = COMMON_RK_CODES , 

DWORD - Sample Rate * 
RKMON_RX_SAMPLE_RATE , 
None 

RKMON_TX_SYMBOL_RATE , 
None 

RKMON_RX_S YMBOL_RATE , 
None 

RKM0N_TX_BIT_RATE , 
None 

RKMON_RX_B IT_RATE , 
None 



// 

DWORD - Sample Rate 
INT - Symbol Rate 
INT - Symbol Rate 
INT - Bit Rate 
INT - Bit Rate 



None 



// 
// 
// 



// 
// 



RKMON__TX_CARR I ER_FREQUENC Y , 

DWORD - (Hz) 
RKMON_RX__CARRIER_ FREQUENCY , 

DWORD - (Hz) 
RKMON_TX_SIGNAL_POWER , 
None Float - (dBm) 

RKMON_RX_S IGNAL_POWER , 
None Float - (dBm) 



// 
// 



None 
None 



// 
// 



// Constellation points 

RKMON_RX_S CATTER , / / 

None float* - pointer to pairs of points 

// Gain needed for scatter plot 

RKMON_RX_NORM_F ACTOR , , / / 

None float 

RKMON_ROUND__TRIP_DELAY , / / 

None INT - R.T.D in 8k samples per sec. 



// M.S.E at Rate selection [dB] 

RKMON_BASE_MSE , 

None Float 

// Mean Square Error [dB] 

RKMON_MSE, 

None Float 

// Signal to Noise Ratio (dB) 
RKMON_SNR , 

None Float 
RKMON_EQM , 

None float - 



// 
// 

// 
// 



(dB) 
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RKMON_SUPPORTED_BIT_RATES_MASK , // 

DWORD (masks of RK_RATE_MAS K_ defined above) 
RKMON FE ECHO DELAY, 



None 



RKMON_AUD 1 0_TX_S AM P LE_RATE , / / 

None DWORD - Sample Rate 

RKMON_AUDIO_RX_SAMPLE_RATE , / / 

None DWORD - Sample Rate 



. RKMON_SETTINGS_INFO, 
RKMON_S ETT I NG S_B LOCKS , 
********* Rksample Constants ********** 

II Num of microseconds in last interrupt 
RKMON_LAST_TNT_CPU = RKSAMPLE_RK_CODES , // 
DWORD 

// Num of microseconds between last 2 interrupts ' 

RKMON_LAST_INT_LATENCY , / / 

None DWORD 

// Num of microseconds in longest interrupt 

RKMON_MAX_INT_CPU , 

None DWORD 

// Longest latency between 2 interrupts (microseconds) 
RKMON_MAX_INT_LATENCY , // 
None DWORD 

// Num of samples overrun occcurred in the past 

RKMON_SAMPLES_ OVERRUNS , // 

None DWORD 

// Num of samples occcurred in the past 

R KMON_S AMPLE S_UNDERRUNS , / / 

None DWORD 

// Num of bus overruns occcurred in the past 
RKMON_BUS_OVERRUNS , // 
None DWORD 

// Num of bus underruns occcurred in the past 
RKMON_BUS_UNDERRUNS , / / 

None DWORD 
// Operating speed 

RKMON_OPERATING_SPEED, // 
None DWORD 



// 



None 



********* winAc Constants ********** 



// Index (WinAc style) of the active modulation 
RKMON_ACTIVE_M0DULATION=WINAC_RK_C0DES , / / 

DWORD 
RKMON_MODEM_STATE , 
None DWORD 
RKMON_MODEM_SLEEP , 
None DWORD 
// RKMON_CALL_SETUP_RES - identical 
// to field no. 1 in AT#UD 
RKMON_CALL_SETUP_RES , 
None DWORD 
// RKMON MULT I MEDIA MODE - identical 



// 



// 
// 



None 
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//to field no. 2 in AT#UD 

RKMON_MULTI_MEDIA_MODE , II 

None DWORD 

// R KMON_V 8_CM - identical to field no. 

// 4 in AT#UD. Returns a pointer to string. 

RKMON_V8_CM , I I 

None PCHAR 

// RKMON_V8_JM - identical to field no. 

// 5 in AT#UD. Returns a pointer to string. 

RKM0N_V8_JM, // 

None PCHAR 

// RKMON_TX_NEG_RES - identical 1 to 

// field no. 20 in AT#UD 

RKMON_TX_NEG_RES , / / 

None DWORD 

// RKMON_RX_NEG_RES - identical to 

// field no. 21 in AT#UD 

RKMON_RX_NEG_RES , 1 1 

None DWORD 

// RKMON__C ARR I ER_LOS S_E V_CNT - 

// identical to field no. 30 in AT#UD 

RKMON_CARRlER_LOSS_EV_CNT , / / 

None DWORD 

// RKMON_RATE_RENEG_EV_CNT - 

// identical to field no. 31 in AT#UD 

RKMON_RATE_RENEG_EV_CNT, // 

None DWORD 

// RKMON_RTRN__REQ - identical to field 

// no. 32 in AT#UD 

RKMON_RTRN_REQ , / / 

None DWORD 

// RKMON_RTRN_G RANTED - identical to 

// field no. 33 in AT#UD 

RKMON_RTRN_GRANTED , II 

None DWORD 

// RKMON__PROTOCOL_NEG_RES - identical 

I I to field no. 40 in AT#UD 

RKMON_PROTOCOL_NEG_RES , / / 

None DWORD 

// RKMON_EC_FRAME_SIZE - identical to 

// field no. 41 in AT#UD 

RKMON_EC_FRAME_S I ZE , / / 

None DWORD 

// RKMON_EC_LINK_TIMEOUTS - identical 

// to field no. 42 in AT#UD 

RKMON_EC_LINK_TIMEOUTS , / / 

None DWORD 

// RKMON_EC_LINK_NAKS - identical to 

// field no. 43 in AT#UD 

RKMON_EC_LINK_NAKS , / / 

None DWORD 

// RKMON_CMPRS_NEG__RES - identical to 

// field no. 44 in AT#UD 

RKMON_CMPRS_NEG_RES , / / 

None DWORD 
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20 



25 



30 
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// RKMON_CMPRS_DICT_SIZE - identical to 
// field no. 45 in AT#UD 
RKMON_CMPRS_DICT_SIZE , 
None DWORD 
// RKMON_TX_FLOW_CTRL - identical to 
// field 'no. 50 in AT#UD 
RKMON_TX_FLOW_CTRL , 
None DWORD 
// RKMON_RX_FL0W_CTRL - identical to 
// field no. 51 in AT#UD 
RKMON_RX_FLOW_CTRL , 
None DWORD 
// RKMON_TOTAL_TX_CHARS - identical to 
// field no. 52 in AT#UD 
RKMON_TOTAL__TX_CHARS , 
None DWORD 
// RKMON_TOTAL_RX_CHARS - identical to 
// field no. 53 in AT#UD 
RKMON_TOTAL_RX_CHARS , 
None DWORD 
// RKMON_TERM INAT 1 0N__CAUS E - identical, 
// to field no. 60 in AT#UD 
RKMON_TERM I NAT 1 0N_C AUSE , 
None DWORD 
// RKMON_CALL_WAI T_E V_CNT - identical 
// to field no. 61 in AT#UD (not supported) 
RKMON_CALL_WAIT_EV_CNT , 
None 

RKMON CPU VENDOR, 



None 

RKMON_CACHE_S I ZE , 
None 

RKMON_NUMBER_CALLED , 
None 

RKMON_TIMER_RESOLUTION , 
DWORD 



DWORD 
PCHAR 
DWORD 
PCHAR 



// 



// 

// 

// 

// 
// 
// 
// 



// 



// 



// 



None 
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a V42 RK_CODES, 



// 



/I ********* V42 Constants ********** 

// Number of V42 BLERS 
RKMON_BLER 

DWORD 

// ********* F ax Constants (V27, V29, V17) ********** 

// Whether Retrain between Pages is Short or Long 
RKMON__LONG_RETRAIN = FAX_RK_CODES , // 

BOOL (TRUE=Long) 



None 



None 



50 



// ********* V34 Constants 



********** 



55 



// Transmit Power Drop [dB] 

RKM0N_TX_P0WER_DR0P = V34_RK_CODES , // 
. INT 

// Power Drop [dB] that was requested from remote modem 

28 



None 
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RKMON_RX_POWER_DROP , 
None 



// 



INT 



// Transmitter Preemphasis Filter 
RKMON_TX_PREEMPHAS I S_F I LTER , 

INT - Filter Index 
// other side's Preemphasis Filter 
RKMON_RX__PREEMPHAS I S__F I LTER , 

INT - Filter Index 



// 
// 



None 



None 



10 
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// Residual Echo in training [dB] 

RKMON_TRN_RE S I DUAL_ECH0 , / / 

None Float 

// Residual Echo in data [dB] (must be sent after 
RKCTL JDATA_RES_ECHO_REQUEST ) 

RKMON_DATA_RES_ECH0_GET , 
None Float 
// Near End Echo [dB] 



20 



25 



30 



35 



40 



45 



50 



RKMON_NE_ECHO_POWER , 
None 

// Far End Echo [dB] 
RKMON_FE_ECHO_POWER , 
None 



Float 



Float 



// 
// 
// 



// Timing Drift [ppm] 

RKMON_T I M I NG_DR I FT , 

None Float 

// Frequency Offset [Hz] 

RKMON_FREQ_OFFSET , 

None Float 



// 
// 



// ********* V90 Constants (K56FLEX, V90) ********** 



// 



(!' indicate robbed bit) 



// Robbed Bits Signaling 
RKMON_RBS_DETECTED = V90_RK_CODES , 
DWORD RBS frame 0 to 63 
// PCM Pad 
RKMON_PAD_DETECTED , 

None DWORD PAD 0= NORMAL, ,3=3dBPad 6=6dBPad 



None 



// High Pass filter enabled 

RKMON__H I GHP AS S_F I LTER__ENAB LED , 

None BOOL - Yes /No 

// ********* speakerPhone Constants ********** 

// Speakerphone Mode (FD, HD, HS) 
RKMON_SPKP_MODE = SPKP_RK_CODES , 

SPKPMode 

// State 
RKMON_STATE, 

None SPKPState 
// Input -Output Mute 



// 



// 



None 



// 
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RKMON_ 1 0_MUTE , . 

SPKP_PROBE 

RKMON_SATURATION , 

SPKP_PROBE 
5 RKMON_DC_LEVEL , 

SPKP_PROBE 

// Echo Cancellers 

RKMON_FILTER_LENGTH , 

SPKP_MODULE 
1 0 RKMON_EC_OPERATE , 

SPKP_MODULE 

RKMON_ADAPT_ENABLED , 

SPKP_MODULE 

RKMON_EC_DELAY , 
15 SPKP_MODULE 

// AGC and Sw-Loss 

RKMON_AMP_ENABLED , 

SPKP_MODULE 

// Powers 
2 0 RKMON_ POWER , 

SPKP_PROBE 

RKMON_NO I S E_POWER , 

SPKP_PROBE 

// Gains 

2 5 RKMON_GAIN, 

{ SPKP_MODULE , GAIN_FORMAT } 
// Gain Estimations 
RKMON_ECHO_PATH_GAIN , 
ECHO_PATH 

3 0 RKMON__EC_GAIN , 

SPKP_MODULE 
RKMON_RES_ECHO_GAIN , 
SPKP MODULE 



35 



40 



4.5 



50 



BOOL - Yes /No 
BOOL - Yes /No 
FLOAT 

INT - No of Taps 
BOOL - Yes /No 
BOOL - Yes /No 
INT - No of Samples 

BOOL - Yes /No 

FLOAT t - Power . [dB] 
FLOAT - Power [dB] 



// 

// 
// 
// 



// 



// 



// 

// 

// 
// 

// 



INT/ FLOAT - Gain [Scaled, dB , Linear] 



FLOAT - Gain [dB] 
FLOAT - Gain [dB] 
FLOAT - Gain [dB] 



// 



// 



// 
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RKMON_INIT_GAIN, 
RKMON_MAX_GAIN , 
RKMON_FULL_DUPLEX_MEASURE , 

RKMON_TONE_DETECT , 

RKMON_NOISE_INSERTION_LENGTH , 
RKMON_NOISE_INSERTION_ENABLE , 

RKMON_FADE_IN JLENGTH , 
RKMON_FADE__IN_ENABLE , 

RKMON_UPSTEP, 

RKMON_MIN_LINE_OUT_POWER , 

RKMON_DMP_MAS K , 

R KMON_L INE_OUT_S I LENCE_G AI N__REDUCT I ON , 

RKMON_INITIAL_FULL_DUPLEX_MEASURE , 

30 
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// ********* voice Constants ********** 

RKMON_VOICE_AVG_POWER = VOICE_RK_CODES , 

5 } RK_MON_CODES ; 

// SPKP Modules 
typedef enum { 

LINE IN_ AMP, 

10 LEC, TONE_DET, RX_SD, RX_SW__LOSS, RX_AGC , 

SPKR_AMP, 
MIC_AMP, 

AEC, TX_SD, TX_SW_LOSS, TX_AGC, 
LINEOUT_AMP , 
15 ALL_MODULES 

} SPKP_MODULE; 

// SPKP Probing points 
typedef enum { 
2 0 LINEIN, 

LEC_IN, LEC_OUT, RX_AGC_OUT, 

SPKR, 

MIC, 

AEC_IN , AEC_OUT , TX_AGC_OUT , 

2 5 LINEOUT, 

ALL_PROBES 
} SPKP_PROBE; 

// Gain Format: dB or Scaled 0-255 

3 0 typedef enum { SCALED , DB , LINEAR } GAIN_FORMAT; 

// Echo Path 

typedef enum { ACOUSTIC , LINE } ECHCMPATH; 

35 // Error Control , Mode 

typedef enum { ENFORCED, EC_OFF, EC_ON} ERROR_CONTROL_MODE ; 

// Modem global state 

typedef enum { STATE_INITIALIZING, STATE_IDLE, S T ATE_OR I G INATE , 

4 0 STATE_ANSWER , 

STATE_V8BIS_HS, /* STATE_MST, */ STATE_ TRAINING , 

STATE_CONNECTED , 

S TATE_E S C APED , STATE_LAL , STATE_LAL_E SCAPED , 

STATE_RDL} MODEM_STATE; 



45 



// Compression Mode 

typedef enum { CMPRS_OFF, CMPRSJDN} COMPRESS ION_MODE; 
#endif // _MODEM_^CODES_H_ 
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#include "dlldef s . h" 
#include "ModemCtrl . h" 
#include "appinterf ace . h" 

#define MAX ERRORMSG LEN 2 00 



HANDLE hModCtrlVxd = NULL; 

10 char ErrorMsg [MAX_ERRORMSG_LEN] ; 

HANDLE WINAPI ModemOpen ( DWORD Code ) 
{ 

PCLIENT_INFO pClient ; 

15 

if ( hModCtrlVxd == NULL | | hModCtrlVxd == I NVAL I D_HANDLE_VALUE ) { 
#ifndef WINDOWS_NT 

hModCtrlVxd = CreateFile ( " \\\\ . \\M0DCTRL . VXD " , 0 # 0, NULL, 

0 , FILE_FLAG_DELETE_ON_CLOSE , 

2 0 NULL) ; 

#else 

hModCtrlVxd = CreateFile ( "\\\\ • \\MODCTRL0" , 

GENERIC_READ | GENERIC_WRITE , 
FILE_SHARE_READ , 
25 NULL, 

OPEN_EXISTING, 
0, 

NULL) ; 

#endif 

3 0 if ( hModCtrlVxd « I NVAL I D_HAND L E__ VALUE ) { 

strncpy( ErrorMsg, "Failed to load MODCTRL . VXD " , 
MAX_ERRORMSG_LEN ) ; 

return FALSE; 

} 

35 } 

unsigned long nBytes; 

BOOL rc - DeviceloControl ( hModCtrlVxd, 

DP_OPEN_MODEM , 

40 &Code, sizeof (DWORD) , 

fcpClient, 

sizeof (PCLIENT_INFO) , 

ScnBytes, NULL ) ; 

if ( rc == 0 ) { 

45 strncpy( ErrorMsg, "DeviceloControl with Code DP_OPEN_MODEM 

Failed", 

MAX_ERRORMSG_LEN ) ; 

return NULL; 

} 

50 

return (HANDLE) pClient ; 
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} 

BOOL WINAPI ModemClose ( HANDLE hModem ) 

5 ^ if ( hModCtrlVxd == NULL ) { 

strncpy( ErrorMsg, "Can't close modem: ModCtrl.vxd not loaded", 

MAX_ERRORMSG_LEN ) ; 

return FALSE; 

} 

10 if ( hModem == NULL ) { 

strncpy( ErrorMsg, "Can't close modem: NULL handle", 

MAX_ERRORMSG_LEN ) ; 

return FALSE; 

} 



15 



unsigned long nBytes; 

PCLIENT_INFO pClient = ( PCL I ENT_INFO) hModem ; 



BOOL rc = DeviceloControl ( hModCtrlVxd, 
20 DP_CLOSE_MODEM, 

tpClient, 

, . sizeof (PCLIENT_INFO) , 

NULL, 0 , 
fcnBytes, NULL ); 

25 if { rc «= 0 ) { 

strncpy( ErrorMsg, "DeviceloControl with Code DP_CLOSE_MODEM 

Failed" — ~ 

MAX_ERRORMSG_LEN ) ; 

return NULL; 

30 } 

return 1; 

} 

DWORD WINAPI ModemGetCodesVersion () 
35 { 

return MODEM_CODES_VERS ION ; 

} 

BOOL WINAPI ModemConf igure (HANDLE hModem, DWORD dwConf igCode , PVOID 
40 plnBuffer, 

DWORD nlnBuf ferSize, PVOID pOutBuffer, DWORD 



nOutBuf f erSize, 



PDWORD pBytesReturned ) 



{ 

4 5 BOOL rc; 

MODEMCTRL_D ATA ModemC t r IDa t a ; 

PCLIENT_INFO pClient = ( PCL IENT_INFO) hModem; 

DWORD BytesReturned; 
tfifdef WINDOW S_NT 
50 UPDATE_S TRUCT UpdateClient ; 

#endif 

if ( hModem « NULL ) { 

strncpy( ErrorMsg, "ModemConf igure failed: HANDLE is NULL", 
5 5 MAX_ERRORMSG_LEN ) ; 
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return FALSE; 

} 

tfifdef WINDOWS_NT 
5 rc = DeviceloControl ( hModCtrlVxd, 

' DP_UPDATE_MODEM , 

fichModem, sizeof (DWORD) , 
^UpdateClient , sizeof <UPDATE_STRUCT) , 
&BytesReturned, NULL ) ; 

10 if ( rc == FALSE ) 

{ 

return FALSE; 

} 

if (( UpdateClient .Status « DPACTIVE ) && (UpdateClient . ID != 
15 RKID_WINAC) ) { 
#else 

if (( pClient -> Status == DPACTIVE ) && (pClient -> ID 
RKID_WINAC) ) { 
#endif 

20 // Can't configure an active modulation, unless it is WinAC. 

strncpy( ErrorMsg, "Modem is active", MAX_ERRORMSG_LEN ); 
return FALSE; 

} 

25 #ifdef WINDOWS_NT 

ModemCtrlData .Object ID = UpdateClient . ID ; 

#else 

ModemCtrlData. Object ID = pClient -> IB; 

#endif 

3 0 ModemCtrlData .Codelndex = dwConf igCode; 

ModemCtrlData. plnBuffer = plnBuffer; 

ModemCtrlData. cblnBuffer = nlnBuf f erSize ; 

ModemCtrlData. pOutBuffer = pOutBuffer; 

ModemCtrlData. cbOutBuffer = nOutBuf f erSize ; 
3 5 ModemCtrlData.pBytesReturned = pBytesReturned; 

rc = DeviceloControl ( hModCtrlVxd, 

DP_CONFIGURE_MODEM , 
^ModemCtrlData, 

40 sizeof (MODEMCTRL_DATA) , 

NULL, 0, 

PBytesReturned, NULL ) ; 

if ( rc == FALSE ) 
45 strncpy( ErrorMsg, "DeviceloControl with Code 

DP_CONFIGURE_MODEM Failed", 

MAX_ERRORMSG_LEN ) ; 

return rc; 

50 } 

BOOL WINAPI ModemControl ( HANDLE hModem, DWORD dwConf igCode , PVOID 
plnBuffer, 

DWORD nlnBuf f erSize, PVOID pOutBuffer, DWORD 

5 5 nOutBuff erSize, 
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PDWORD pBytesRe turned ) 

{ 

BOOL rc ; 

PCLIENT^IN^O pClient = <PCLIENT_INFO) hModem; 

DWORD By tesRe turned; 
#ifdef WINDOWS_NT 

UPDATE_STRUCT UpdateClient; 

#endif 

MODEMCTRLJDATA ModemCtr iData ; 



if { pClient == NULL ) { 

strncpy( ErrorMsg, "ModemControl failed: HANDLE is NULL", 
MAX_ERRORMSG_LEN ) ; 

return FALSE; 

15 } 

#ifdef WINDOWS_NT 

rc = DeviceloControl ( hModCtrlVxd, 

DP_UPDATE_MODEM , 
fchModem, sizeof (DWORD) , 
20 ■ SUpdateClient, sizeof (UPDATE_STRUCT) , 

&BytesReturned, NULL ) ; 

if ( rc «= FALSE ) 
{ 

return FALSE; 

25 } . 

if ( UpdateClient .Status != DPACTIVE ) { 

#else 

if { pClient -> Status != DPACTIVE ) { 

#endif 

30 strncpy( ErrorMsg, "modem is not active", MAX_ERRORMSG_LEN ); 

return FALSE; 

} 

#ifdef WINDOWS_NT 
35 ModemCtr IData. Object ID = UpdateClient . ID; 

#else 

ModemCtr IData. Ob jectID = pClient -> ID; 

#endif 

ModemCtrlData.Codelndex = dwConf igCode ; 
4 0 ModemCt r IData. plnBuffer = plnBuffer; 

ModemCtrlData.cblnBuf fer = nlnBuff erSize ; 
ModemCtr lDat a. pOutBuffer = pOutBuffer; 
ModemCtr IData . cbOutBuf fer = nOutBuff erSize ; 
ModemCt rlDat a. pBytesRe turned. = pBytesRe turned; 

45 

rc = DeviceloControl ( hModCtrlVxd, 

D P_CONTROL_MODEM , 
&ModemCtr IData , 

sizeof (MODEMCTRL_DATA) , 
50 NULL, 0, 

fcBytesRe turned, NULL ) ; 

if ( rc == FALSE ) 

strncpy{ ErrorMsg, "DeviceloControl with Code DP_CONTROL_MODEM 

55 Failed", 

35 



;nnr:in- *wn swwsfiQAAi i > 



WO 99/45694 



PCT/US99/04690 



} 



MAX_ERRORMSG_LEN ) ; 

return rc; 



BOOL WINAPI ModemMonitor ( HANDLE hModem, DWORD dwConf igCode, PVOID 
plnBuf f er , 

DWORD nlnBuf f erSize, PVOID pOutBuffer, DWORD 

nOutBuf f erSize, 
10 PDWORD pBytesReturned ) 

{ 

BOOL rc ; 

PCLIENT_INFO pClient = (PCLIENT_INFO) hModem; 

MODEMCTRL_DATA ModemCt r IDat a ; 

15 DWORD Byte sRe turned; 

#ifdef WINDOWS_NT 

UPDATE_STRUCT UpdateClient; 

#endif 

2 0 if ( pClient == NULL ) { 

strncpy( ErrorMsg, "ModemMonitor failed: HANDLE is NULL", 
MAX_ERRORMSG_LEN ) ; 

return FALSE ; 

} 

25 

#ifdef WINDOWS_NT 

rc = Device I oControl ( hModCtrlVxd, 

DP_UPDATE_MODEM , 
&hModem, sizeof (DWORD) , 
30 &UpdateClient , sizeof ( UPD ATE_S TRUCT ) 

PBytesReturned, NULL ) ; 

if ( rc == FALSE ) 
{ 

return FALSE; 

35 } 

if ( UpdateClient .Status ! = DPACTIVE ) { 

#else 

if ( pClient -> Status != DPACTIVE ) { 

#endif 

40 //strncpy( ErrorMsg, "Modem is not active", MAX_ERRORMSG_LEN ) 

return FALSE; 

} 



45 #ifdef WINDOWS__NT 

ModemCtr IDat a. Object ID = UpdateClient . ID; 

#else 

ModemCtrlData. Object ID = pClient -> ID; 

tfendif 

50 ModemCtrlData. Codelndex = dwConf igCode ; 

ModemCtr IData . plnBuf f er = plnBuf fer; 

ModemCtrlData. cblnBuffer = nlnBuf f erSize ; 

ModemCtrlData. pOutBuffer = pOutBuffer; 

ModemCtrlData. cbOutBuffer = nOutBuff erSize ; 
55 ModemCtrlData. pBytesReturned = pBytesReturned; 
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rc = DeviceloControl ( hModCtrlVxd, 

DP_MONITOR_MODEM , 
( t &ModemCtrlData, 

sizeof (MODEMCTRL_DATA) , 

pOutBuf f er, nOutBuf f erSize, 
pBytesReturned, NULL ) ; 

if ( rc == FALSE ) 

stmcpyf ErrorMsg, "DeviceloControl with Code DP_MONITOR_MODEM 

Failed", 

MAX_ERRORMSG_LEN ) ; 

return rc; 

} 

VOID WINAPI ModemGetLastError ( PCHAR pBuf, DWORD nBuf ) 
strncpy( pBuf, ErrorMsg, nBuf ); 

} 
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CLAIMS 

1. A communication system comprising: 
a modem; 

a communication channel; 

the modem having internal settings representing communication parameters, the 
modem being communicatively coupled to the communication channel to carry out ongoing 
communications from the modem through the communication channel; and 

a software module being associated with the modem, the software module accessing 
the internal settings of the modem via the communication channel and performing diagnostics 
using the internal settings of the modem. 

2. The communication system of claim 1 wherein the software module further 
comprises a modem interface that interacts with the software module and assists the software 
module in performing diagnostics using the internal parameters of the modem. 

3. The communication system of claims 1 or 2 wherein the software module 
accesses the communication channel transparently to the ongoing communications from the 
modem when the software module performs the diagnostics using the internal parameters of 
the modem. 

4. The communication system of claims 1 wherein the software module accesses 
the communication channel without detrimentally affecting the ongoing communications 
across the communication channel. 

5. The communication system of claims 1, 2, or 4 wherein the software module 
performs diagnostics using the internal parameters of the modem via the same 
communication channel that is used to carry out ongoing communications to and from the 
modem. 

6. The communication system of claim 1 wherein the diagnostics performed by 
the software module comprise monitoring a data stream in the communication channel. 

38 



) 9945694A1_I_> 



WO 99/45694 PCT/US99/04690 

7. The communication system of claims 1, 2, 4, or 6 wherein the diagnostics 
performed by the software module comprise configuring the internal settings of the modem 
based on information obtained regarding a data stream to and from the modem. 

8. The communication system of claims 1, 2, 4, or 6 wherein the diagnostics 

5 performed by the software module comprise controlling the internal settings of the modem 
according to information obtained regarding a data stream to and from the modem. 

9. The communication system of claims 1, 2, 4, or 6 wherein the software 
module further comprises a user interactive interface for diagnostics. 

1 0. The communication system of claims 1 , 2, 4, or 6 further comprising a 

i o plurality of software modules being associated, respectively, with each of a plurality of 
modems. 

1 1. The communication system of claims 1, 2, 4, or 6 wherein the modem is 
communicatively coupled to the communication channel and thus to a network. 

12. The communication system of claims 1, 2, 4, or 6 wherein the network is 

is selected from the group consisting of a local area network, a wide area network, and a global 
area network. 
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